home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Monster Media 1996 #15
/
Monster Media Number 15 (Monster Media)(July 1996).ISO
/
win_utl2
/
oh2b30d.zip
/
OH1TO2.TXT
< prev
next >
Wrap
Text File
|
1996-04-04
|
9KB
|
185 lines
Copyright 1996, Hyperion Softword
*************************************
* Orpheus 2, beta release 2.00.30 *
*************************************
Comments and queries to: Hyperion Softword,
535 Duvernay, Sherbrooke, QC J1L 1Y8, Canada
tel/fax - 819-566-6296 (Rod Willmot)
email - willmot@interlinx.qc.ca
Contents of this file: Purpose
Usage
Registered Users
Disk Space Requirements
Step 1: The Converter
For More - See Online Help
PURPOSE:
========
OH1TO2.EXE (The Converter) is a utility for converting Orpheus 1.nn
files to the Orpheus 2 standard. Projects to be converted must be in
uncompiled format, not HTX's. OH1TO2 does not delete or overwrite the
original project. You should not dispose of the original until you are
fully satisfied with your results using Orpheus 2.
USAGE:
======
Give the following command at the DOS prompt:
OH1TO2
The Converter will take over from there, asking what you want to
convert and where you want the new version to go. It's safe, easy
to use, and interactive. As discussed later on this document, it
even lets you pause during conversion to free up disk space.
REGISTERED USERS:
=================
If you are a registered user of Orpheus 1 (any version), and are
using a copy of Orpheus 2 received from any shareware source (BBS,
Internet archive, CD-ROM, etc), please note that you must obtain
a KEY file from Hyperion Softword in order for Orpheus 2 to recognize
you as a registered user. Until you do so, anything you compile
with the new version will invoke the "unregistered shareware" warning
from the Reader.
Users who purchased Orpheus 1.64-1.65 at the full price ($79 *US*)
will receive a complete upgrade package, including KEY file, when
Orpheus 2 is officially ready. If you're happy with Orpheus 2 even
in beta form and want your KEY file as quickly as possible, give me
a voice call at 819-566-6296 and we'll arrange for you to download
it directly from me. Or I can email it to you as a file attachment.
Users who purchased earlier versions of Orpheus, or who paid less
than the current price in US dollars, will receive an upgrade offer
in the mail. Again, if you're in a hurry just give me a call.
DISK SPACE REQUIREMENTS:
========================
The Converter does not delete or overwrite any of the files from the
original version of a project. The converted (Orpheus 2) version is
stored in a different set of directories. This means that if you
have an enormous project to convert, and little free disk space,
you will need to free up space either before or during the conversion
process. Don't panic. Read on. This is a friendly Converter.
If you NEED to free up space and are not using a disk-compression system
such as Stacker or Doublespace, you will have to offload files onto
diskette. If you are not using a disk-compression system, a better
method is to compress rarely-used files with PKZIP. Actually the best
method in both cases is to do a little house-cleaning... I've never seen
a file that didn't beg to be deleted. (We're lean and mean, here at
Hyperion Softword.)
Once you have told the Converter what you want to convert, and where
you want it to store the new version, the program analyzes the original
project and estimates how much disk space it will need. As conversion
proceeds you can watch the indicators showing remaining free space and
space still needed. At any time, you can interrupt processing by
pressing the <Spacebar>. This opens the "OH1to2 paused" dialog,
which has three options: press the <Spacebar> again to resume, press
<Esc> to abort conversion, or press <Alt-S> to shell to DOS.
Use this last option (shelling to DOS) to offload files onto diskette or
compress files with PKZIP, assuming you need to free up space. When you
return from the shell by giving the "exit" command at the DOS prompt,
you'll be back in the "OH1to2 paused" dialog and can resume processing,
abort processing, or even shell to DOS again. It's neat shelling out
without spending a dime.
STEP 1: THE CONVERTER:
======================
The first step is to run OH1TO2 on the project you want to convert.
When you start the program the opening dialog asks for the following
input:
Old Project:
[............................................................]
New Name:
[........]
New Path:
[............................................................]
In the "Old Project" field, enter the full path to the project you
wish to convert, ending with the name of the project itself. For
example, if you have a TEST project based in the C:\ORPHEUS\
directory, enter "C:\ORPHEUS\TEST".
In the "New Name" field, enter the name you wish to use for the
Orpheus 2 version of the project. It can be the same as the original
if you wish, but you might prefer a different name to avoid confusion,
such as TEST2 if the original was TEST. The name can be up to 8
characters long; it cannot include a path or file extension.
In the "New Path" field, enter the full path to where you want the
converter to store the Orpheus 2 version of the project. This MUST be
a different from the location of the original version. If any directories
named in the path do not exist, the Converter will create them. For
example, suppose you are using C:\OH2 as your directory for your Orpheus 2
program files. You can also use this as the base directory for your
converted projects. In this case you would enter "C:\OH2" -- just the
path, not the name of the project itself.
->> In Orpheus 2, project directory names are identical to the project
name itself; they do not end with an underscore as in Orpheus 1. For
example, the TEST project under Orpheus 1 would have a project directory
named TEST_, but under Orpheus 2 it would just be TEST. Following our
example, using TEST2 as the new name would result in a project directory
named C:\OH2\TEST2\. The new project file, TEST2.PRJ, would be stored
in C:\OH2\.
Once you've filled the Old Project, New Name, and New Path fields to
your satisfaction, tab to the "Begin Conversion" command and press <Enter>.
The Converter makes sure everything seems right before going on.
The next stage begins with a scan of your old project. The Converter
examines every storage directory in it, counting up how many cards you
have. Then it displays an estimate of the amount of disk space needed
along with the disk space currently free. Since OH1TO2 does *not*
delete or overwrite your old project's files, the free space will
diminish as conversion proceeds. As discussed above under "Disk Space
Requirements", you can pause conversion at any time, then either abort
or shell to DOS in order to free up more space.
When the conversion is complete, you may see a message warning you
about script commands requiring further updating on your part. This
is discussed later on under "Updating Script Commands".
FOR MORE - SEE ONLINE HELP
==========================
Complete documentation on using the Converter, and on other important
aspects of moving up to Orpheus 2, is available in online help. While
in OH.EXE, press <F1> to open Help, and from the Contents page select
"Orpheus Utilities->OH1TO2.EXE->Documentation". Everything in this
file is included, along with the following additional topics:
Results of Step 1
What Got Changed
Step 2: You and OH.EXE
The Reader Interface
The Resource Path
Concatenating "More" Links
Updating Script Commands
Since the Help version includes hypertext links to everything in the
Orpheus system, and since you may be doing further conversion while
working in OH.EXE, you will find that much easier to use than this
file. You can even print out hard copy from Help.